The MAME story: 

FROM C TO MODERN C + + 


MIODRAG MILANOVIC 


Who am I ? 


Working as software developer from October 2000 
Experience in C, C++, C#, Java, ... 

Software architect in Levi9 - Serbia 

From April 2012 coordinator of MAME project 
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Who we are ? 


About 50 active developers 
Over 200 contributors 
Team contains : 

° experienced developers (gaming and not gaming related) 
° emulation enthusiasts 

Community: 

• Developers of different experience 

• Software dumpers 

• Documentation acquirers 

• Testers 



What is MAME? 


Multiple Arcade Machine Emulator 
Nicola Salmoria started project 1997 
MESS as sister project 
Preservation of software 
Accuracy over performance 



Misconception about MAME 


Made for playing free games 
Is game itself 

Way to sell new arcade cabinets 
Perfect solution for all emulation 
Platform for enhancing games 



Why preservation of software is important ? 


Companies do not backup all their software 
Things get lost 

Storage mediums are unreliable 

It is always easy to find just "good" and "nice" software 

It is not possible to buy some software for bit older platforms 
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What we wish MAME is used for 


Learning about old hardware 
Understanding concepts from the past 
Preserve hardware and software 
Developing new software for old hardware 
Relive your childhood 
Practice ground for new C++ features 


What we do not do ? 


Do not emulate recent hardware (if not permitted by author(s)) 

Do not support recent software unless permitted (min 3 year after end of production) 
Do not try to improve how things look and work 
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What we actually do ? 




http://siliconprOn.org/ 

http://www.visual6502.org/ 





Current statistics 


10960 text files . 
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C++ source size : 151 M 
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GitHub trending 
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Growth trending 


MAME Evolution 


40000 


35000 


30000 


25000 


20000 


15000 


10000 


5000 


0 



12 



Development Tools 


On Windows: 

° MSYS2 + MinGW-w64 (note that all other distributions do not have threading support) 
° MSYS2 + Clang 
° Visual Studio 2015 

On Linux/FreeBSD: 

° GCC5.X + 

° Clang 3.5 + 

On OSX / macOS : 

° Xcode 
° Clang 
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Commercial tools 


ReSharper C++ + Visual Studio 2015 = Ultimate Development Windows Tool 
° Do code analysis part by part 
° Document your code where applicable 

PVS Studio 

° Static Code Analyzer for C, C++ and C# 

° Used evaluation version 
° Have been used as one of test cases 

° Software diseases: memset ( http://www.viva64.eom/en/b/0154y from 2012) 
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Why do we do it ? 


"We do these things not because they are easy, but because they are 
hard" 

-John F. Kennedy, 1962 
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Let's see how MAME looks 
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MAME debugger version 0.175 (mame0175-54-gd34724b-dirty) 


Currently targeting 1941 (1941: Counter Attack (World 900227)) 
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I M Errorlog: 1941: Counter Attack (World 900227) [1941] X 

I Debug 
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M MAME: Sun 2/120 [sun2_120] - □ X 


Self Test completed successfully. 

Sun Workstation, Model Sun-2/120 or Sun-2/170, Sun-2 keyboard 
ROM Rev R, 2MB memory installed 
Serial #1660, Ethernet address 8:0:20:2:78:37 

Probing Multibus: ip ie ec 
Using RS232 A input. 

Auto-boot in progress... 

Boot: ip (0, 0, 0) vmunix 
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How modernization started ? 


Plain C project till February 2009 
Aaron Giles started conversion to C++ 
2015 going modern C++ 
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Why converting to C++ ? 


Was quite hard to understand code even for existing developers. 
Learning curve was bad, so we could not attract new developers. 

Adding new functionality was hard, since it side effects were not clear. 
Lot of global variables making reuse of specific parts of code impossible. 
Code reuse was not clear. 

Global symbol pollution was high. 

We wish to have "code as documentation" approach. 
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First steps 


Compile your C code as C++ 

Treat warnings as errors 

Use multiple compilers on multiple platforms 
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OOP 


Recognize classes and objects in your code 
Recognize connections between them 
Object oriented is great and natural way of documenting 
Do not create over-engineered model of classes 
Express your thoughts 


24 



First problems 


Global variables 
Large number of macros 
No tools to help this process 
Enforcing coding conventions 
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Manual labor 

Team effort, but keep group working on conversion close 

Remove all deprecated code once you remove their usage 

Doing one small change you will end up redoing large portion of code 

Keep track of changes 

Clean/reformat your code 
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Automatization 


Try using REGEX when applicable 

Custom made tools - mostly for recognizing pattern of usage and doing replaces 

Clang-tidy for modernization (for moving to modern C++) 

° modernize-use-nullptr 
° modernize-use-override 
° modernize-use-using 
° modernize-use-default 
° modernize-use-bool-literals 
° modernize-use-auto 
° modernize-make-unique 
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make_unique_clear 


template<typename Tp> struct MakeUniqClearT { typedef std: :unique_ptr<Tp> single_object ; }; 

template<typename Tp> struct Mak:eUniqClearT<Tp [] > { typedef std: :unique_ptr<Tp [] > array; }; 

template<typename Tp, size_t Bound> struct MaJceUniqClearKTp [Bound] > { struct invalid_type { }; > 

/// maJce_unique_clear for single objects 
template<typename Tp, typename... Params> 

inline typename Mak:eUniqClearT<Tp>: : single_object mak:e_unique_clear (Params&& . . . args) 

{ 

void ‘const ptr = : : operator new(sizeof (Tp) ) ; // allocate memory 
std: rmemset (ptr , 0, sizeof(Tp)); 

return std: :unique_ptr<Tp>(new(ptr) Tp(std: : forward<Params>(args ) ...)); 

> 

/// mak:e_unique_clear for arrays of unknown bound 
template<typename Tp> 

inline typename MaJceUniqClearT<Tp>: : array malce_unique_clear (size_t num) 

{ 

auto size = sizeof (std: : remove_extent_t<Tp>) * num; 

unsigned char* ptr = new unsigned char [size]; // allocate memory 

std: :memset (ptr , 0, size); 

return std: :unique_ptr<Tp>(new(ptr) std: : remove_extent_t<Tp>[num] ()) ; 

> 

template<typename Tp, unsigned char F> 

inline typename MaJceUniqClearT<Tp>: : array mak:e_unique_clear (size_t num) 

{ 

auto size = sizeof (std: : remove_extent_t<Tp>) * num; 

unsigned char* ptr = new unsigned char [size]; // allocate memory 

std: :memset (ptr , F, size); 

return std: :unique_ptr<Tp>(new(ptr) std: : remove_extent_t<Tp>[num] ()) ; 

> 

/// Disable malce_unique_clear for arrays of known bound 
template<typename Tp, typename... Params> 

inline typename MalceUniqClearT<Tp>: : invalid_type maJce_unique_clear (Params&& . . . ) = delete; 


28 



Variadic templates 


templatectypename _ClassType, typename _ReturnType, typename... Param3> 
struct delegate_traits 
{ 

typedef _ReturnType (*static_func_type) (_ClassType *, Param3 . . . ) ; 
typedef _ReturnType (*3tatic_ref_func_tvpe) (_Clas3Tvpe &, Params . . . ) ; 
typedef _ReturnType (_ClassType: : *member_func_type) (Params. . .) ; 

) ; 


// helper stubs for calling encased member function pointers 
template<cla33 _FunctionClass , typename _ReturnType, typename. . . Params> 
static _ReturnTvpe method_3tub (delegate_generic_class *object, Params ... args) 

{ 

delegate_mfp *_this = reinterpret_cast<delegate_mfp *>(object) ; 
typedef _ReturnType (_FunctionClass : :*mfptype) (Params. . .) ; 
mfptvpe &mfp = *reinterpret_cast<mfptype *>(&_this->m_rawdata) ; 

return (reinterpret_cast<_FunctionCla3s *>(_this->m_realobject) ->*mfp) (std: : forward<Params>(arg3) . . .) ; 

} 
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Constexpr 


/* Concatenate/extract 32-bit halves of 64-bit values */ 

con3texpr UINT64 concat_64 (UINT32 hi, UINT32 lo) { return (UINT64 (hi) « 32) | UINT32 (lo) ; ) 

constexpr UINT32 extract_64hi (UINT64 val) { return UINT32 (val » 32); } 

constexpr UINT32 extract 641o(UINT64 val) { return UINT32 (val) ; ) 


#ifdef LSB_FIRST 

constexpr UINT16 big_endianize_intl6 (UINT16 x) { return f lipendian_intl6 (x) ; ) 
constexpr UINT32 big endianize int32 (UINT32 x) { return flipendian int32 (x) ; } 


constexpr 

UINT64 

big endianize int64 (UINT64 x) 

{ 

return flipendian int64 (x) ; } 


constexpr 

UINT16 

little endianize intl6(UINT16 

x) 

{ 

return 

x; ) 



constexpr 

UINT32 

little endianize int32 (UINT32 

x) 

{ 

return 

x; } 



constexpr 

UINT64 

little endianize int64 (UINT64 

X) 

{ 

return 

x; ) 



telse 









constexpr 

UINT16 

big endianize intl6(UINT16 x) 

{ 

return x; 

> 



constexpr 

UINT32 

big endianize int32 (UINT32 x) 

{ 

return x; 

> 



constexpr 

UINT64 

big endianize int64 (UINT64 x) 

{ 

return x; 

> 



constexpr 

UINT16 

little endianize int!6 (UINT16 

X) 

{ 

return 

flipendian 

intl6 (x) ; 

} 

constexpr 

UINT32 

little endianize int32 (UINT32 

X) 

{ 

return 

flipendian 

int32 (x) ; 

} 

constexpr 

UINT64 

little endianize int64 (UINT64 

X) 

{ 

return 

flipendian 

int64 (x) ; 

} 

#endif / * 

LSB FIRST */ 









These were macros 
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And more constexpr 


// Highly useful template for compile-time knowledge of an array size 

template <typename T, size t N> constexpr size t ARRAY LENGTH(T (&)[N]) { return N;> 


constexpr 

UINT16 

constexpr 

UINT32 

constexpr 

UINT32 

constexpr 

UINT64 

constexpr 

UINT64 

constexpr 

UINT64 


flipendian_intl6 (UINT16 val) { return (val « 8 ) | (val » 8) ; } 

f Iipendian_int32_partiall6 (UINT32 val) { return ((val « 8) & OxFFOOFFOOU) | ((val » 8) & OxOOFFOOFFU) ; } 
f lipendian_int32 (UINT32 val) { return (f Iipendian_int32_partiall6 (val) « 16) | (f Iipendian_int32_partiall6 (val) » 16); ) 

f Iipendian_int64_partiall6 (UINT64 val) { return ((val « 8) & U64 (OxFFOOFFOOFFOOFFOO) ) | ((val » 8) & U64 (OxOOFFOOFFOOFFOO 
f Iipendian_int64_partial32 (UINT64 val) { return ( (flipendian_int64_partiall6 (val) « 16) & U64 (OxFFFFOOOOFFFFOOOO) ) | ( (fli 
flipendian int64 (UINT64 val) { return (flipendian int64 partial32 (val) « 32) | (flipendian int64 partial32 (val) » 32); ) 
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New features that helped clean 


std::mutex 

std::thread 

atomics 

chrono 
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Still not able to convert 


void *osd_alloc_executable (size_t size) 

{ 

#if defined (SDLMAME_BSD) || defined (SDLMAME_MACOSX) 

return (void *)mmap(0, 3ize, PROT_EXEC| PROT_READ| PROT_WRITE, MAP_ANON | MAP_SHARED , -1, 0) ; 
#elif defined (SDLMAME_UNIX) 

return (void *)mmap(0, size, PROT_EXEC | PROT_READ | PROT_WRITE , MAP_ANON | MAP_SHARED , 0, 0) ; 
#endif 
) 

void osd_f ree_executable (void *ptr, size_t size) 

{ 

♦ifdef SDLMAME_SOLARIS 

munmap((char *)ptr, size); 

#else 

munmap(ptr, size); 

#endif 

) 

void *osd_alloc_executable (size_t size) 

{ 

return VirtualAlloc (nullptr, size, MEM_COMMIT , PAGE_EXECUTE_READWRITE) ; 

) 

void osd_f ree_executable (void *ptr, size_t size) 

{ 

VirtualFree (ptr , 0, MEM_RELEASE) ; 

) 


Linux / macOS 


Windows 
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Things we wish to use 


Coroutines 

° Experimented with https://byuu.org/library/libco/ got bad results due to stackful implementation 
° Wait state implementation 
° For networking layer implemenatation 

Modules 

• Too big compile times right now (30-40 on latest hardware) 

• Ideal since we need quite large amount of definitions (currently using #include "emu.h" in each 
separate emulator) 


GSL 
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And from the tech side : 


Fully working Android build 
iOS build 

Console build (Xbox One and PS4) 

Various VR systems 
Hololens 

Interaction with real hardware (using loT devices as proxies) 
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GENie project generator 

https://github.com/bkaradzic/GENie/ 

GENie (pronounced as Jenny) is project generator tool. It automagically generates project from 
Lua script, making applying the same settings for multiple projects easy. 

Supported project generators: 

FASTBuild (experimental) 

GNU Makefile 
Ninja (experimental) 

Qbs / QtCreator (experimental) 

Visual Studio 2008, 2010, 2012, 2013, 2015, 15 
XCode 
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Why using GENie ? 


Can generate all compilers we are targeting 
Based on LUA 
Easy extensible 

Enables us to create custom/partial builds 
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Example usage 


— SoftFloat library objects 


project "softfloat" 

uuid "04fbf89e-4761-4cf2-8al2-64500cf0c5c5 n 
kind "StaticLib" 


options { 

"ForceCPP", 

} 


includedirs { 

MAME_DIR .. "src/osd", 

} 

configuration { "vs*" } 
buildoptions { 

"/wd4244", — warning C4244: 'argument' : conversion from 'xxx' to 'xxx', possible loss of data 
n /wd4146", — warning C4146: unary minus operator applied to unsigned type, result still unsigned 
"/wd4018", — warning C4018: 'x' : signed/unsigned mismatch 

} 

if _OPTIONS [ "vs" ] ="intel-15" then 
buildoptions { 

"/Qwd2557", — remark #2557: comparison between signed and unsigned operands 

} 

end 

configuration { } 


files { 

MAME_DIR . . 
MAME_DIR . . 
NAME DIR . . 


"3rdparty/ sof tf loat/sof tf loat . c" , 
"3rdparty/ softfloat/f sincos . c", 
"3rdparty/softfloat/fyl2x. c". 
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How does MAME works? 


// license :BSD-3-Clause 
// copyright-holders :Robbbert 

♦include "emu.h" 

♦include "bus/rs232/rs232 .h" 

♦include "cpu/s2650/s2650 .h" 

♦include "machine/terminal .h" 

♦include "imagedev/snapquik.h" 

class pipbug_state : public driver_device 

< 

public: 

pipbug_state (const machine_config Smconfig, device_type type, const char *tag) 
: driver_device (mconfig, type, tag), 
m_rs232 (‘this, "rs232") , 
m_maincpu(*this, "maincpu") 

( 

) 

DECLARE J9RITE8_MEMBER (pipbug_ctrl_w) ; 
required_device<rs232_port_device> m_rs232 ; 
requir ed_device<cpu_device> m_maincpu ; 

) ; 

WRITE8_MEMBER( pipbug_state : :pipbug_ctrl_w ) 

( 

// 0x80 is written here - not connected in the baby 2650 

) 

static ADDRESS_MAP_START (pipbug_mem, AS_PROGRAM, 8, pipbug_state) 

ADDRE S S_MAP_UNMAP_HIGH 
AM_RANGE( 0x0000, 0x03ff) AM_ROM 
AM_RANGE( 0x0400, 0x7fff) AM_RAM 
ADDRESS MAP END 
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static ADDRESS_MAP_START (pipbug_io , AS_IO, 8, pipbug_3tate) 

AM_RANGE(S2650_CTRL_PORT, S2650_CTRL_PORT) AM_WRITE (pipbug_ctrl_w) 
AM_RANGE(S2650_SENSE_PORT, S2650_SENSE_PORT) AM_READNOP 
ADDRESS MAP END 


/* Input ports */ 

static INPOT_PORTS_START ( pipbug ) 
INPUT PORTS END 


static DEVICE_INPUT_DEFAULTS_START( terminal ) 

DEVICE_INPUT_DEFAULTS ( "RS232_TXBAUD" , Oxff, RS232_BAUD_110 > 

DEVI CE_INPUT_DE FAULTS ( "RS232_RXBAUD" , Oxff, RS232_BAUD_110 > 
DEVICE_INPUT_DEFAULTS ( "RS232_STARTBITS" , Oxff, RS232_STARTBITS_1 
DEVI CE_INPUT_DE FAULTS ( "RS232_DATABITS" , Oxff, RS232_DATABITS_7 ) 
DEVICE_INPUT_DEFAULTS ( "RS232_PARITY" , Oxff, RS232_PARITY_EVEN > 
DEVICE_INPUT_DEFAULTS ( "RS232_STOPBITS" , Oxff, RS232_STOPBITS_l ) 
DEVICE INPUT DEFAULTS END 


static MACHINE_CONFIG_START ( pipbug, pipbug_3tate ) 

/* basic machine hardware */ 

MCFG_CPU_ADD ( "maincpu" , S2650 , XTAL_lMHz) 

MCFG_CPU_PROGRAM_MAP (pipbug_mem) 

MCFG_CPU_IO_MAP (pipbug_io) 

MCFG S26S0 FLAG HANDLER (DEVWRITELINE ("rs232", rs232_port_device , write_txd) ) 


<- Simplified example 


/* video hardware */ 

MCFG_RS232_PORT_ADD("rs232", def ault_rs232_devices , "terminal") 

MCFG_RS232_RXD_HANDLER( INPUTLINE ("maincpu" , S2650_SENSE_LINE) ) 

MC FG_DEVI CE_CARD_DEVI CE_INPUT_DE FAULT S ( "terminal" , terminal) 

MACHINE_CONFIG_END 

/* ROM definition */ 

ROM_START( pipbug ) 

ROM_REGION( 0x8000, "maincpu", ROMREGION_ERASEFF ) 

ROM_LOAD ( "pipbug. rom", 0x0000, 0x0400, CRC (f242b93e) SHA1 (f 82857cc882e6b5f c9f 00b20b375988024f 413f f ) ) 

ROM_END 

/* Driver */ 

/* YEAR NAME PARENT COMPAT MACHINE INPUT INIT COMPANY FULLNAME FLAGS */ 

COMP ( 1979, pipbug, 0, 0, pipbug, pipbug, driver_device , 0, "Signetics", "PIPBUG", MACHINE_NO_SOUND_HW ) 
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Delegates 

class MyClass { 
int i; 

public: 

MyClassQ : i(0) { } 

virtual ~MyClass() { } 

virtual void docount(int) { i++; } 

}; 

typedef delegate<void(int value)> callback_delegate; 

MyClass me; 

callback_delegate md = callback_delegate(FUNC(MyClass::docount), &mc); 
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Why we needed delegates? 


Providing callback functionality between various objects 
Late binding (resolving objects referenced in runtime) 
Minimal cost (using method function pointers) 
Implemented in period of using C++ 98 


https://github.com/mamedev/delegates 
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Speed measurement 


Compiler 

Version 

OS 

Time fast 
delegates 
native (ns) 

Time 

std::function/bind 

(ns) 

MinGWGCC 

5.3.0 x64 

Windows 

131547400 

216178100 

MinGWGCC 

5.3.0 x86 

Windows 

131160000 

285218800 

Clang 

3.8.0 x64 

Windows 

100766900 

219475700 

GCC 

4.9.2 ARM 

Linux (RasPi2) 

1120924321 

4146617167 

GCC 

5.3.1x64 

Linux 

139180356 

205068909 

Clang 

3.7.0 x64 

Linux 

140548960 

182060144 

Clang Apple 

7.3.0 x64 

OSX 

125145702 

262906798 

GCC 

5.3.1 ARM64 

Linux (Odroid-C2) 

654185671 

1370827564 

GCC 

4.9.2 MIPSEL 

Linux (Creator Ci20) 

1002793705 

3341533518 
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3 rd party libraries and tools 

BGFX- Branimir Karadzic 
LUA-PUCRio 
RapidJSON- Milo Yip 
GLM - GL Math 
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BGFX (1/2) 

Cross-platform, graphics API agnostic, "Bring Your Own Engine/Framework" style rendering library. 

Supported rendering backends: 

Direct3D 9 
Direct3D 11 
Direct3D 12 (WIP) 

Metal (WIP) 

OpenGL 2.1 
OpenGL 3.1+ 

OpenGL ES 2 
OpenGL ES 3.1 
WebGL 1.0 
WebGL 2.0 
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BGFX (2/2) 

Supported compilers: 

Clang 3.3 and above 
GCC 4.6 and above 
vs2008 and above 

Linux 

MIPS Creator CI20 

Native Client (PPAPI 37+, ARM, x86, x64, PNaCI) 

OSX (10.9+) 

RaspberryPi 

SteamLink 

Windows (XP, Vista, 7, 8, 10) 

WinRT (WinPhone 8.0+) 


Supported platforms: 

Android (14+, ARM, x86, MIPS) 
asm.js/Emscripten (1.25.0) 
FreeBSD 

iOS (iPhone, iPad, AppleTV) 


46 



How do BGFX fi es ook ike ? 


fs blit. sc 


$input v_colorO, v_texcoordO 

#include "common. sh" 

SAMPLER2D (s_tex, 0) ; 

void main() 

{ 

gl_FragColor = texture2D(s_tex, v_texcoordO) * v_colorO; 

} 


V3 blit . sc 


$input a_position, a_texcoordO, a_colorO 
$output v_texcoordO, v_colorO 

#include "common. 3h" 

void main() 

n 

gl_Po3ition = mul (u_viewPro j , vec4 (a_position . xy , 0. 
v_texcoord0 = a_texcoord0; 
v_color0 = a_color0; 

} 


, 1 . 0 )) 
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Make your code public 


Better feedback from users 

Commits become better since people are aware more are looking at their work 
More people get interested in project -> more pull requests 
Do not use private repository sites to distribute your code 
GIT over SVN 

Do regular releases (we do it each last Wednesday of month) 
https://github.com/mamedev/mame 
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Why join open source project? 


Share your ideas 
Experiment 

Improve your knowledge 

Knowledge gained during work on open source projects help you do your regular work. 
Meet more people, learn from them. 
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What do we wish to offer to C++ ? 


Delegates 

Input handling implementation based on delegates 
Definition of math for 2D and 3D graphics 
Runtime shader transpiling 

Let us be your playground 
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DEMO 
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Q&A 


Contact : 

° mmicko@gmail.com 

° Twitter : https://twitter.com/micko mame 
° GitHub : https://github.com/mamedev/mame 
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